home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 006a / dizman12.zip / DIZMAN.DOK < prev    next >
Text File  |  1993-05-31  |  32KB  |  643 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║ ┌──────────   ┌───── ┌────────── ┌────   ┌────  ┌──────────  ┌────    ┌───  ║
  3. ║ ┌───    ┌───   ┌───        ┌───  ┌───── ┌───── ┌───     ┌─── ┌─────   ┌───  ║
  4. ║ ┌───     ┌───  ┌───       ┌───   ┌─── ┌── ┌─── ┌───     ┌─── ┌───┌──  ┌───  ║
  5. ║ ┌───     ┌───  ┌───      ┌───    ┌───  ┌  ┌─── ┌──────────── ┌─── ┌── ┌───  ║
  6. ║ ┌───     ┌───  ┌───     ┌───     ┌───     ┌─── ┌───     ┌─── ┌───  ┌──┌───  ║
  7. ║ ┌───     ┌───  ┌───    ┌───      ┌───     ┌─── ┌───     ┌─── ┌───   ┌─────  ║
  8. ║ ┌───    ┌───   ┌───   ┌───       ┌───     ┌─── ┌───     ┌─── ┌───    ┌────  ║
  9. ║ ┌──────────   ┌───── ┌────────── ┌───     ┌─── ┌───     ┌─── ┌───     ┌───  ║
  10. ╚═════════════════════════════════════════════════════════════════════════════╝
  11.  
  12.        Dokumentation für DizMan v1.20, geschrieben 1993 von Stefan Kuhn.
  13.  
  14.  Diese Dokumentation wurde ziemlich schnell zusammengeschrieben! Falls Unklar-
  15.  heiten  auftreten,  so  teilt  mir  diese  bitte (genauso wie etl. Fehler von
  16.  DizMan) mit.
  17.                                                                    Stefan Kuhn
  18.  
  19. ╔═════════════════════════════════════════════════════════════════════════════╗
  20. ║                             Was macht DizMan?                               ║
  21. ╚═════════════════════════════════════════════════════════════════════════════╝
  22.  
  23.       - DizMan  sucht in gepackten Dateien nach FILE_ID.DIZ Beschreibun-
  24.         gen (oder aehnlichen),  liest diese aus und fuegt sie als Datei-
  25.         Beschreibung in die FILES.BBS ein!
  26.  
  27.       - DizMan erweitert die Beschreibungen diverser Bild-Formate um die
  28.         Auflösung des Bildes.
  29.  
  30.       - DizMan bearbeitet auch diverse Soundformate.  Dabei werden deren
  31.         interne (Modul-)Namen in die FILES.BBS geschrieben.
  32.  
  33. ╔═════════════════════════════════════════════════════════════════════════════╗
  34. ║                             Warum gerade DizMan?                            ║
  35. ╚═════════════════════════════════════════════════════════════════════════════╝
  36.  
  37.       - DizMan's größter Vorteil ist, daß Du jederzeit die orinal Datei-
  38.         Beschreibung aus der  FILE_ID.DIZ in der FILES.BBS hast.  Es be-
  39.         steht also kein Grund die Beschreibung zu aendern,  denn die Be-
  40.         schreibung des Autors ist wohl immer noch die Beste!
  41.  
  42.       - DizMan schuetzt dein System vor Benutzern, die solch schwachsin-
  43.         nige Beschreibungen wie "Ein suuuuuuuuper Utility!" oder "Klasse
  44.         Song!" zu ihrem Upload schreiben.
  45.  
  46.       - DizMan  sollte eigentlich mit jedem BBS-System zusammenarbeiten,
  47.         das eine FILES.BBS Liste fuehrt.
  48.  
  49.       - DizMan  ist in höchstem Maße konfigurierbar!  So kannst Du z. B.
  50.         neue Packer oder Grafik- & Sound-Formate einfach nachkonfigurie-
  51.         ren.
  52.  
  53.       - DizMan wird mit einer Beispiel-Konfiguration vertrieben, mit der
  54.         es auf ARJ/DWC/HA/HAP/HPK/HYP/LZH/PAK/SQZ/ZIP/ZOO Archiven,  den
  55.         sogenannten Selfextracting Archiven der Packer  ARJ/LZH/PAK/ZIP,
  56.         den Grafikformaten  BMP/GIF/JPG/LBM/MAC/MSP/PCX/PIC/RLE/SCX  und
  57.         den  Soundformaten JMS/MOD/NST/S3M/SD4/STM/STS/669  (auch  Fast-
  58.         Tracker 6 & 8 Kanal-Formate) arbeitet.
  59.  
  60. ╔═════════════════════════════════════════════════════════════════════════════╗
  61. ║                                Achtung... :-)                               ║
  62. ╚═════════════════════════════════════════════════════════════════════════════╝
  63.  
  64.              Ich bin für ABSOLUT NICHTS verantwortlich,  was deinem
  65.              System zustoesst!
  66.  
  67.              Es ist nicht erlaubt  DizMan  kommerziell einzusetzen.
  68.              Jedes System (MailBox) das 4 oder mehr  Leitungen hat,
  69.              oder dessen Zugang nicht kostenfrei ist,  oder das in
  70.              einem kommerziellen Umfeld eingesetzt wird,  gilt als
  71.              kommerzielles System.
  72.  
  73. ╔═════════════════════════════════════════════════════════════════════════════╗
  74. ║                                REGISTRIERUNG                                ║
  75. ╚═════════════════════════════════════════════════════════════════════════════╝
  76.  
  77.  DizMan ist nicht Public Domain und auch nicht kostenlos! Es ist ShareWare!
  78.  
  79.  Nicht registrierten Benutzern  dieses Programms wird eine 30-tägige Nutzungs-
  80.  dauer gewährt, in der sie prüfen können, ob sich das Programm für ihre Zwecke
  81.  eignet. Wird DizMan mehr als 30 Tage benutzt,  so ist eine Registrierung not-
  82.  wendig!  Die Benutzung von unregistrierten  DizMan  Versionen über eine Dauer
  83.  von 30 Tagen hinaus ist verboten.
  84.  
  85.  Registrier-Gebühren:
  86.  
  87.         Nicht-Kommerzielle Benutzer in der BRD      DM   10,-
  88.         Kommerzielle Benutzer in der BRD            DM   20,-
  89.  
  90.         Andere nicht-kommerzielle Benutzer          US$  10,-
  91.         Anderes kommerzielle Benutzer               US$  20,-
  92.  
  93.  Merke: Du mußt den Registrier-Code von  meinem System  pollen!  Solltest  Du
  94.         nicht in der Lage sein bei meinem System zu pollen, so mußt Du leider
  95.         DM 5,- (US$ 5,-) mehr bezahlen. Der Registrier-Code wird Dir dann zu-
  96.         geschickt.
  97.  
  98.  Um DizMan zu registrieren überweise die Registriergebühr bitte an:
  99.  
  100.         Stefan Kuhn
  101.         Volksbank Passau-Freyung eG
  102.         BLZ     : 740 900 00
  103.         Kto.-Nr.: 4771 6
  104.  
  105.         Bitte schreibe deinen vollen  Namen,  Adresse,  BBS Namen,  FidoNet-
  106.         Adresse  und den Namen des Programmes auf den Empfängerabschnitt der
  107.         Überweisung.  Ansonsten  kann  die  Registrierung  nicht  bearbeitet
  108.         werden!
  109.  
  110.  Oder schicke die Registriergebühr im Briefumschlag an:
  111.  
  112.         Stefan Kuhn                        Stefan Kuhn
  113.         Stallerweg 12                      Stallerweg 12
  114.         8390 Passau-Rittsteig              94036 Passau-Rittsteig
  115.         Germany                            Germany
  116.  
  117.                                            (Benutze dies nach dem 1.7.93)
  118.  
  119.  Für weitere Informationen kannst Du mit mir per NetMail Kontakt aufnehmen:
  120.  
  121.         Stefan Kuhn
  122.  
  123.         2:246/222.0@FidoNet
  124.         9:494/6000.0@VirNet
  125.         22:32/9.0@RockyNet
  126.         23:100/21.0@KultNet
  127.         94:510/301.0@CDN
  128.  
  129.  Nachdem  Du deinen Registrier-Code erhalten hast,  trägst Du diese einfach in
  130.  die DIZMAN.CFG ein (siehe auch RegCode).
  131.  
  132.  Sollte ich eine neue Version von  DizMan  schreiben ( wird wohl kommen ;-) so
  133.  so  brauchst Du diese nicht nochmals registrieren.  Mit anderen Worten:  Alle
  134.  UpDates sind frei!
  135.  
  136.  Bitte  schreibe Dir deinen Registrier-Code  auf und verschlamp ihn nicht.  So
  137.  ersparst Du dir und mir ne Menge Arbeit & Ärger ;-)
  138.  
  139. ╔═════════════════════════════════════════════════════════════════════════════╗
  140. ║                       Vertrieb & Verkauf von DizMan                         ║
  141. ╚═════════════════════════════════════════════════════════════════════════════╝
  142.  
  143.  1. Ich untersage den Vertrieb / Verkauf von DizMan über PD/Shareware Händler.
  144.     Sollte irgendein Händler DizMan vertreiben / verkaufen woll, so braucht er
  145.     meine schriftliche Zustimmung.
  146.  
  147.  2. DizMan darf auf MailBoxen Anderen zum Download zugänglich gemacht werden.
  148.  
  149.  3. DizMan darf auch ohne  meine Zustimmung Shareware-Packeten  (z.B. MailBox-
  150.     Software)  beigepackt werden.  Dies gilt jedoch nicht,  wenn dieses Packet
  151.     über PD/Shareware Händler vertrieben / verkauft wird (siehe #1).
  152.  
  153.  Die Vertriebs-/Verkaufs-Bedingungen #2 und #3 gelten nur,  wenn  Dizman  kom-
  154.  plett ist, also die folgenden Dateien umfaßt:
  155.                                                      
  156.     DIZMAN.EXE    Das ausführbare Programm.
  157.     DIZMAN.DIR    Ein Beispiel für eine DirList-Datei.
  158.     DIZMAN.DOC    Die englische Dokumentation.
  159.     DIZMAN.DOK    Die deutsche Dokumentation. (Diese Datei)
  160.     DIZMAN.CFG    Die Beispiel-Konfiguration.
  161.     FILE_ID.DIZ   Die Kurzbeschreibung von DizMan.
  162.     FILE_ID.DOC   Eine Beschreibung des FILE_ID.DIZ Formats.
  163.  
  164. ╔═════════════════════════════════════════════════════════════════════════════╗
  165. ║                        Wie wird DizMan konfiguriert?                        ║
  166. ╚═════════════════════════════════════════════════════════════════════════════╝
  167.  
  168.  Erzeuge eine Text-Datei als Konfigurations-Datei (nimm am besten DIZMAN.CFG).
  169.  
  170.  DizMan versteht die folgenden Schlüsselwörter:
  171.  
  172. ┌─────────────────────────────────────────────────────────────────────────────┐
  173. │ Register                                                                    │
  174. └─────────────────────────────────────────────────────────────────────────────┘
  175.  
  176.  Startet eine  REGISTER  Umgebung, um deine Namen und Registrier-Code zu defi-
  177.  nieren.
  178.  
  179. ┌─────────────────────────────────────────────────────────────────────────────┐
  180. │ RegName <string>                                                            │
  181. └─────────────────────────────────────────────────────────────────────────────┘
  182.  
  183.  Definiert den Namen, auf den DizMan registriert ist.
  184.  
  185. ┌─────────────────────────────────────────────────────────────────────────────┐
  186. │ BbsName <string>                                                            │
  187. └─────────────────────────────────────────────────────────────────────────────┘
  188.  
  189.  Definiert den BBS-Namen, auf den DizMan registriert ist.
  190.  
  191. ┌─────────────────────────────────────────────────────────────────────────────┐
  192. │ RegCode <string>                                                            │
  193. └─────────────────────────────────────────────────────────────────────────────┘
  194.  
  195.  Definniert den Registrier-Code.
  196.  
  197. ┌─────────────────────────────────────────────────────────────────────────────┐
  198. │ End Register                                                                │
  199. └─────────────────────────────────────────────────────────────────────────────┘
  200.  
  201.  Schliesst eine REGISTER Umgebung.
  202.  
  203. ┌─────────────────────────────────────────────────────────────────────────────┐
  204. │ Settings                                                                    │
  205. └─────────────────────────────────────────────────────────────────────────────┘
  206.  
  207.  Startet eine SETTINGS Umgebung, um die DizMan Default-Werte zu setzen.
  208.  
  209. ┌─────────────────────────────────────────────────────────────────────────────┐
  210. │ TempDir <path>                                                              │
  211. └─────────────────────────────────────────────────────────────────────────────┘
  212.  
  213.  Das TempDir Schlüsselwort definiert ein  Directory für DizMan's temporäre Da-
  214.  teien.
  215.  
  216. ┌─────────────────────────────────────────────────────────────────────────────┐
  217. │ DirList <filename>                                                          │
  218. └─────────────────────────────────────────────────────────────────────────────┘
  219.  
  220.  Mit DirList kann eine Directory-Liste definiert werden, die DizMan sukzessive
  221.  abarbeitet.  Es können so mehere Directories mit den dazugehörigen  FILES.BBS
  222.  definiert werden.  Falls DirList nicht definiert ist,  so müssen die zu bear-
  223.  beitenden Dateien über die Commandline definiert werden!
  224.  
  225.  Die DirList-Datei hat das folgende Format:
  226.  
  227.     <path>[<filename>] [@<filename>]
  228.  
  229.  Die folgenden Einträge wären also o.k. für die DirList-Datei:
  230.  
  231.     D:\FILES
  232.     D:\FILES\
  233.     D:\FILES\*.*
  234.     D:\FILES\*.ARJ
  235.     D:\FILES           @D:\LISTS\FILES.BBS
  236.     D:\FILES\          @D:\LISTS\FILES.BBS
  237.     D:\FILES\*.*       @D:\LISTS\FILES.BBS
  238.     D:\FILES\*.ARJ     @D:\LISTS\FILES.BBS
  239.  
  240. ┌─────────────────────────────────────────────────────────────────────────────┐
  241. │ LogFile <filename>                                                          │
  242. └─────────────────────────────────────────────────────────────────────────────┘
  243.  
  244.  Mit dem LogFile Schluesselwort kann man ein sog. Log-File definieren,  in dem
  245.  die Aktivitaeten von DizMan mitprotokolliert werden. Wenn Du ein Log-File ha-
  246.  ben willst, dann musst Du LogFile angeben und zwar z.B. so:
  247.  
  248.  LogFile          C:\DIZMAN\DIZMAN.LOG
  249.  
  250. ┌─────────────────────────────────────────────────────────────────────────────┐
  251. │ SwapFile <filename>                                                         │
  252. └─────────────────────────────────────────────────────────────────────────────┘
  253.  
  254.  Mit SwapFile kann eine Datei definiert werden,  in die DizMan beim Aufruf ex-
  255.  terner Programme swapped (falls nicht genügend EMS zu Verfügung steht).
  256.  
  257.  SwapFile         C:\DIZMAN\DIZMAN.$$$
  258.  
  259. ┌─────────────────────────────────────────────────────────────────────────────┐
  260. │ SaveFilesBbsExt <file-extension>                                            │
  261. └─────────────────────────────────────────────────────────────────────────────┘
  262.  
  263.  SaveFilesBbsExt  definiert  die  Datei-Extension   des   FILES.BBS   BackUps.
  264.  Default-Extension ist BAK.
  265.  
  266. ┌─────────────────────────────────────────────────────────────────────────────┐
  267. │ ProcessLastDays <number>                                                    │
  268. └─────────────────────────────────────────────────────────────────────────────┘
  269.  
  270.  Das  ProcessLastDays  Schlüsselwort gibt an,  wie alt eine Datei maximal sein
  271.  darf, um von DizMan bearbeitet zu werden. Falls DizMan nur Dateien bearbeiten
  272.  soll,  die jünger  als x Tage sind,  dann setze ProcessLastDays auf x.  Falls
  273.  alle Dateien bearbeitet werden sollen, so setze ProcessLastDays auf 0.
  274.  Default: 0. Range: 0-100.
  275.  
  276. ┌─────────────────────────────────────────────────────────────────────────────┐
  277. │ AddOrphan                                                                   │
  278. └─────────────────────────────────────────────────────────────────────────────┘
  279.  
  280.  Das AddOrphan Schlüsselwort sagt DizMan, daß es auch Dateien bearbeiten soll,
  281.  die noch nicht in der FILES.BBS aufgeführt sind.
  282.  
  283. ┌─────────────────────────────────────────────────────────────────────────────┐
  284. │ OrphanDesc <string>                                                         │
  285. └─────────────────────────────────────────────────────────────────────────────┘
  286.  
  287.  Mit  OrphanDesc  wird die Beschreibung für Dateien,  die neu in die FILES.BBS
  288.  aufgenommen werden, definert.
  289.  
  290. ┌─────────────────────────────────────────────────────────────────────────────┐
  291. │ Ignore <filename>                                                           │
  292. └─────────────────────────────────────────────────────────────────────────────┘
  293.  
  294.  Das  Ignore  Schlüsselwort veranlaßt DizMan alle definierten Dateien nicht zu
  295.  bearbeiten. Es koennen maximal 50 Ignores definiert werden.
  296.  
  297. ┌─────────────────────────────────────────────────────────────────────────────┐
  298. │ DizName <filename>                                                          │
  299. └─────────────────────────────────────────────────────────────────────────────┘
  300.  
  301.  Das  DizName  Schlüsselwort definiert den / die Namen der Dateien, nach denen
  302.  DizMan in Archiven suchen soll.  Die erste,  die gefunden wird,  wird als Be-
  303.  schreibung in die FILES.BBS aufgenommen. Du kannst bis zu 10 DizName definie-
  304.  ren. Keine Wildcards!
  305.  
  306. ┌─────────────────────────────────────────────────────────────────────────────┐
  307. │ CutDiz <number>                                                             │
  308. └─────────────────────────────────────────────────────────────────────────────┘
  309.  
  310.  Mit dem  CutDiz  Kommando  kann man die  maximale Zeilenlänge des FILE_ID.DIZ
  311.  Textes einstellen. Ein Wert von x bewirkt eine Kürzung jeder FILE_ID.DIZ Zei-
  312.  le auf x Zeichen.  Wenn deine Datei-Beschreibungen z. B. bei Spalte 35 begin-
  313.  nen, so solltest Du CutDiz auf 45 setzen.
  314.  Default: 45. Range: 0-255 (0 = kein Kürzen).
  315.  
  316. ┌─────────────────────────────────────────────────────────────────────────────┐
  317. │ NoLongDesc                                                                  │
  318. └─────────────────────────────────────────────────────────────────────────────┘
  319.  
  320.  Das  NoLongDesc  Schlüsselwort wir benutzt,  falls lange Datei-Beschreibungen
  321.  (also als Kommentar in die FILES.BBS eingefügt) nicht erwünscht sind.  Beach-
  322.  te:  Der automatische Zeilenumbruch der meisten BBS Systeme kann ganz schönen
  323.  Müll produzieren! Default: aus.
  324.  
  325. ┌─────────────────────────────────────────────────────────────────────────────┐
  326. │ BeginLongDesc <number>                                                      │
  327. └─────────────────────────────────────────────────────────────────────────────┘
  328.  
  329.  Das BeginLongDesc Schlüsselwort wird benutzt, um die Anfangsspalte der langen
  330.  Dateibeschreibungen zu definieren. Default: 1. Range: 1-255.
  331.  
  332. ┌─────────────────────────────────────────────────────────────────────────────┐
  333. │ LongDescStartStr <string>                                                   │
  334. └─────────────────────────────────────────────────────────────────────────────┘
  335.  
  336.  Falls Du eine  bestimmte Zeichenfolge am Anfang jeder  Zeile einer langen Da-
  337.  teibeschreibung wünschst, so kannst Du diese mit dem LongDescSatrtStr Schlüs-
  338.  selwort definieren. Default: Kein Start-String.
  339.  
  340. ┌─────────────────────────────────────────────────────────────────────────────┐
  341. │ KillHiAscii                                                                 │
  342. └─────────────────────────────────────────────────────────────────────────────┘
  343.  
  344.  Das  KillHiAscii  Schlüsselwort veranlasst DizMan alle Hi-Ascii's  (also alle
  345.  Asccii-Zeichen über 127)  beim Einfügen des FILE_ID.DIZ Textes durch Leerzei-
  346.  chen zu ersetzen.  Die  deutschen  Umlaute  Ä, Ö, Ü, ä, ö, ü, ß  werden dabei
  347.  durch Ae, Oe, Ue, ae, oe, ue, ss ersetzt. Default: aus.
  348.  
  349. ┌─────────────────────────────────────────────────────────────────────────────┐
  350. │ KillMultiBlanks                                                             │
  351. └─────────────────────────────────────────────────────────────────────────────┘
  352.  
  353.  Wenn KillHiAscii und NoLongDesc gesetzt sind,  dann  empfiehlt  es  sich auch
  354.  KillMultiBlanks  anzuschalten!  Dann  werden  alle 'langen Leerzeichen' (also
  355.  eine Folge von Zeichen #32) durch ein  'kurzes  Leerzeichen'  (ein  einzelnes
  356.  Zeichen #32) ersetzt. Dies funktioniert nur, wenn NoLongDesc an ist!
  357.  Default: aus.
  358.  
  359. ┌─────────────────────────────────────────────────────────────────────────────┐
  360. │ MaxDizLines <number>                                                        │
  361. └─────────────────────────────────────────────────────────────────────────────┘
  362.  
  363.  Mit MaxDizLines kann festgelegt werden,  wieviele Zeilen des FILE_ID.DIZ Tex-
  364.  tes für die Datei-Beschreibung verwendet werden sollen.
  365.  Default: 255. Range: 0-255.
  366.  
  367. ┌─────────────────────────────────────────────────────────────────────────────┐
  368. │ SaveFirstDescLine                                                           │
  369. └─────────────────────────────────────────────────────────────────────────────┘
  370.  
  371.  Falls SaveFirstDescLine gesetzt ist,  so behält DizMan beim Einfügen des Tex-
  372.  tes aus der  FILE_ID.DIZ  Datei die erste Zeile der alten  Datei-Beschreibung
  373.  bei. Default: aus.
  374.  
  375. ┌─────────────────────────────────────────────────────────────────────────────┐
  376. │ ShowDlTime <string>                                                         │
  377. └─────────────────────────────────────────────────────────────────────────────┘
  378.  
  379.  Ist ShowDlTime gesetzt, so fügt DizMan als letzte Zeile der  FILE_ID.DIZ  Be-
  380.  schreibung die geschätzte Downloadzeit ein. Bei der Definition von ShowDlTime
  381.  können die folgenden Symbole verwendet werden:
  382.  
  383.    %bx    - Definiert die Baudrate (x = Baudrate)
  384.    %h     - Erzwingt die Anzeige der Stunden
  385.    %m     - Erzwingt die Anzeige der Minuten
  386.    %s     - Erzwingt die Anzeige der Sekunden
  387.  
  388.  Beispiel:  ShowDlTime %b2400bps %h:%m:%s * %b14400bps %h:%m:%s
  389.  
  390.             Erzeugt etwa eine Zeile wie:
  391.  
  392.             2400bps 00:17:29 * 14400bps 00:02:54
  393.  
  394.  Default-mäßig erzeugt DizMan kein DL Zeit-Info.  ShowDlTime hat nur eine Wir-
  395.  kung, falls NoLongDesc nicht gesetzt ist.
  396.  
  397. ┌─────────────────────────────────────────────────────────────────────────────┐
  398. │ CounterStyle <char><char>                                                   │
  399. └─────────────────────────────────────────────────────────────────────────────┘
  400.  
  401.  Das CounterStyle Schlüsselwort definiert,  welche Begrenzer der Download-Zäh-
  402.  ler verwendet.
  403.  
  404. ┌─────────────────────────────────────────────────────────────────────────────┐
  405. │ CounterLength <number>                                                      │
  406. └─────────────────────────────────────────────────────────────────────────────┘
  407.  
  408.  Das CounterLength Schlüsselwort definiert, wieviele Stellen der Download-Zäh-
  409.  ler hat. Wenn Du z.B. CounterLength auf 4 setzt, so stehen 4 Zeichen zwischen
  410.  den Begrenzern des Download-Zählers. Die Download-Zahlen werden nicht automa-
  411.  tisch durch 0 angeführt, sondern durch Leerzeichen (also z.B. [   0]).
  412.  Default: 0. Range 0-10 (0 = kein Zähler).
  413.  
  414. ┌─────────────────────────────────────────────────────────────────────────────┐
  415. │ SpaceForZero                                                                │
  416. └─────────────────────────────────────────────────────────────────────────────┘
  417.  
  418.  Ist  SpaceForZero  gesetzt,  so verwendet DizMan Leerzeichen statt Nullen für
  419.  ein Download-Zähler der gleich Null ist.  Also nimmt DizMan z.B. [    ] statt
  420.  [   0]. Default: Nullen satt Leerzeichen.
  421.  
  422. ┌─────────────────────────────────────────────────────────────────────────────┐
  423. │ ZeroPadded                                                                  │
  424. └─────────────────────────────────────────────────────────────────────────────┘
  425.  
  426.  Das ZeroPadded Schlüsselwort veranlasst DizMan die Download-Zähler mit Nullen
  427.  statt Lerrzeichen aufzufüllen (also [0001] statt [   1]).
  428.  Default: Leerzeichen.
  429.  
  430. ┌─────────────────────────────────────────────────────────────────────────────┐
  431. │ End Settings                                                                │
  432. └─────────────────────────────────────────────────────────────────────────────┘
  433.  
  434.  Schließt eine SETTINGS Umgebung.
  435.  
  436. ┌─────────────────────────────────────────────────────────────────────────────┐
  437. │ Archive                                                                     │
  438. └─────────────────────────────────────────────────────────────────────────────┘
  439.  
  440.  Startet eine ARCHIVE Umgebung.  Du kannst bis zu 50 verschieden Archive Umge-
  441.  bungen definieren!  DizMan prüft alle Archive Typen anhand des  Ident  in der
  442.  Reihenfolge ihrer Definition. Also Vorsicht:  Verändere nicht die Reihenfolge
  443.  von ARC/PAK/HYP!
  444.  
  445. ┌─────────────────────────────────────────────────────────────────────────────┐
  446. │ ArcName <packername>                                                        │
  447. └─────────────────────────────────────────────────────────────────────────────┘
  448.  
  449.  ARCNAME gibt den Namen des Archivers an.
  450.  
  451. ┌─────────────────────────────────────────────────────────────────────────────┐
  452. │ Ident <offset>,<hex-string>                                                 │
  453. └─────────────────────────────────────────────────────────────────────────────┘
  454.  
  455.  Wenn Du nicht 100% vertraut bist mit den Internas der Kompressions-Programme,
  456.  dann solltest Du die Finger vom  IDENT  Schlüsselwort lassen. Zwei Parameter,
  457.  durch Kommata getrennt, folgen dem Ident Kommando.  Wenn DizMan ein unbekann-
  458.  tes Archiv bearbeitet, dann verwendet es diese beiden Parameter um das Archiv
  459.  zu identifizieren.
  460.  
  461.  Die  erste  Zahl  hinter Ident definiert den Offset an dem die  signifikanten
  462.  Bytes des Archivs stehen.  Positive Einträge werden genauso behandelt wie man
  463.  es gewohnt ist.  Negative Einträge können benutzt werden, um Offsets vom Ende
  464.  der Datei zu bestimmen.  Ein Offset von  "-1"  ist also das letzte Byte einer
  465.  Datei, und ein Offset von "-2" das vorletzte Byte usw.
  466.  
  467.  Nach dem Offset kommt eine Serie von Hexadezimal-Zahlen,  die den Text reprä-
  468.  sentieren, der am definierten Offset in der Datei zu finden ist. So wird z.B.
  469.  ein  großes "A" durch  die "41" dargestellt,  was der ASCII Code des "A"  ist
  470.  (in Hexadezimal). Zeichenfolgen können einfach durch eine Sequenz von hexade-
  471.  zimal Zahlen definiert werden.
  472.  
  473. ┌─────────────────────────────────────────────────────────────────────────────┐
  474. │ Command <commandline>                                                       │
  475. └─────────────────────────────────────────────────────────────────────────────┘
  476.  
  477.  Mit dem COMMAND Schlüsselwort definierst Du wie DizMan gepackte  Dateien ent-
  478.  packen soll.  Ein "%a" wird dabei durch den Namen der gepackten Datei und ein
  479.  "%f" durch den Namen der zu entpackenden Datei ersetzt.
  480.  
  481.  Ein  "*"  als erstes Zeichen nach dem  COMMAND  Befehl wird benutzt um einige
  482.  Spizial-Dateien zu bearbeiten.  Du kannst dann die Datei Beschreibung in eine
  483.  einheitliche Form bringen. Du kannst dazu die folgenden Symbole verwenden:
  484.  
  485.    %bx    = schreibt den Byte-Wert, der am Offset "x" in der zu bearbeitenden
  486.             Datei steht in die Beschreibung.
  487.    %d     = wird ersetzt durch die alte Beschreibung aus der FILES.BBS
  488.    %e+a,b = Wird durch das Ergebis von 'a + b' ersetzt.
  489.    %e-a,b = Wird durch das Ergebis von 'a - b' ersetzt.
  490.    %e*a,b = Wird durch das Ergebis von 'a * b' ersetzt.
  491.    %e/a,b = Wird durch das Ergebis von 'a DIV b' ersetzt.
  492.    %e&a,b = Wird durch das Ergebis von 'a AND b' ersetzt.
  493.    %e<a,b = Wird durch das Ergebis von 'a SHL b' ersetzt.
  494.    %e>a,b = Wird durch das Ergebis von 'a SHR b' ersetzt.
  495.    %fa    = Durchsucht die zu bearbeitende  Datei nach dem Hex-String 'a' und
  496.             wird durch dessen Offset ersetzt.
  497.    %sx,y  = schreibt die Zeichenfolge der Länge "y", die ab Offset "x" in der
  498.             zu bearbeitenden Datei sthet in die Beschreibung.
  499.    %wxlh  = schreibt den Word-Wert, der am Offset "x" in der zu bearbeitenden
  500.             Datei steht in die Beschreibung. (niederwertiges Byte zuerst!)
  501.    %wxhl  = schreibt den Word-Wert, der am Offset "x" in der zu bearbeitenden
  502.             Datei steht in die Beschreibung. (niederwertiges Byte zuletzt!)
  503.  
  504.  Merke: Der Unterschied zwischen %whl und %wlh ist wie folgt: Angenommen eine
  505.  Datei beginnt mit dem Hex-String '12 34 D4 FF ..', dann würde %wlh0 den Hex-
  506.  String 3412h zu '13330' verarbeiten und %whl0 verarbeitet 1234h zu '4660'.
  507.  
  508. ┌─────────────────────────────────────────────────────────────────────────────┐
  509. │ End Archive                                                                 │
  510. └─────────────────────────────────────────────────────────────────────────────┘
  511.  
  512.  Schließt eine ARCHIVE Umgebung.
  513.  
  514. ╔═════════════════════════════════════════════════════════════════════════════╗
  515. ║                           Wie ruft man DizMan auf?                          ║
  516. ╚═════════════════════════════════════════════════════════════════════════════╝
  517.  
  518.    Syntax:
  519.  
  520.         DIZMAN.EXE <filename> [options]
  521.  
  522.    Derzeit versteht DizMan die folgenden Optionen:
  523.  
  524.         /?                Um eine Kurzhilfe anzuzeigen.
  525.  
  526.         /C<filename>      Definiert die Konfigurations-Datei, die Dizman
  527.                           benutzen soll. Default: DIZMAN.CFG
  528.  
  529.         /F<filename>      Definiert die  FILES.BBS  ähnliche Datei,  die
  530.                           Dizman benutzen soll.
  531.  
  532.    Beispiele:
  533.  
  534.         DIZMAN.EXE *.*
  535.  
  536.         DIZMAN.EXE TEST.A?? /CC:\BBS\DIZMAN\DIZMAN.CFG
  537.  
  538.         DIZMAN.EXE F:\MSDOS\*.* /FC:\CD1\MSDOS.BBS
  539.  
  540. ╔═════════════════════════════════════════════════════════════════════════════╗
  541. ║                        Was hat sich seit V1.00 getan?                       ║
  542. ╚═════════════════════════════════════════════════════════════════════════════╝
  543.  
  544.         1.20 - Neu: Verbesserungen an allen Tags im  'special command'
  545.                sowie Einführung des %e und des %f Tags.
  546.  
  547.                Neu: Unterstützt nun auch PCX und JPG ohne HSI Header.
  548.  
  549.                Neu: Jetzt kann DizMan die Anzahl der Farben für alle
  550.                unterstützten Grafik-Formate in die Beschreibung ein-
  551.                fügen (ausser bei SCX --- Ich weiss leider nicht,  wo
  552.                bei diesem Format die Farbanzahl steht ;-)
  553.  
  554.         1.11 - Neu: Der %w Tag im 'Special Command' wurde durch %wlh
  555.                ersetzt und der %whl Tag wurde neu implementiert.
  556.  
  557.                Neu: Nun auch BMP/JPG/LBM/MAC/MSP/PIC/RLE/SCX Support.
  558.  
  559.         1.10 - Neu: DizMan hat eine neue "Oberfläche" bekommen.  Jetzt
  560.                kann man im DOS WINDOW mitverfolgen,  was die Packer so
  561.                treiben.
  562.  
  563.                Neu: DizMan ruft jetzt die  externen  Programme  direkt
  564.                auf, d.h. COMMAND.COM frisst den Packern nicht mehr den
  565.                Speicher weg.
  566.  
  567.                Neu: DizMan swapped jetzt beim Aufruf externer Program-
  568.                me in den EMS oder auf die Platte! Dadurch wird den ex-
  569.                ternen Programmen nun wesentlich mehr Speicher zur Ver-
  570.                fügung gestellt (DizMan braucht nur noch ca 30K). Siehe
  571.                auch unter SWAPFILE.
  572.  
  573.                Neu: DizMan kann jetzt acht neue Formate (S3M, ARJ SFX,
  574.                LHA SFX, PAK SFX, ZIP SFX).
  575.  
  576.                Neu: Das KillMultiBlanks Kommando wurde eingeführt, um
  577.                die Unterstützung  von  einzeiligen  Beschreibungen zu
  578.                verbessern.
  579.  
  580.                BugFix: DizMan  fügt nun ein Leerzeichen zwischen zwei
  581.                Zeilen der  FILE_ID.DIZ  Beschreibung  ein falls keine
  582.                mehrzeiligen Beschreibungen gewünscht werden.
  583.  
  584.         1.01 - Die  Beispiel-Konfiguration wurde  leicht  geändert und
  585.                die Unterstützung der Packer HA sowie HAP&PAH  hinzuge-
  586.                fügt.
  587.  
  588.              - Neu: Diese deutsche Dokumentation gibt's nun auch ;-)
  589.  
  590.              - Neu: Es besteht jetzt die Moeglichkeit ein Log-File er-
  591.                stellen zu lassen.
  592.  
  593.              - Neu: Es kann nun eine Directory-Liste mit DirList defi-
  594.                niert werden, die DizMan dann sukzessive abarbeitet.
  595.  
  596.              - Neu: Ist KillHiAscii gesetzt,  so  werden die deutschen
  597.                Umlaute Ä, Ö, Ü, ä, ö, ü, ß  nun durch  Ae, Oe, Ue, ae,
  598.                oe, ue, ss ersetzt!
  599.  
  600.              - BugFix: Wenn  SaveFirstDescLine  gesetzt  war  und  die
  601.                erste Zeile der FILE_ID.DIZ war eine Leerzeile, so lan-
  602.                dete die alte Beschreibung im Nirwana.
  603.  
  604.              - BugFix: Wenn SaveFirstDescLine und KillHiAscii  gesetzt
  605.                waren und die erste Zeile der alten  Datei-Beschreibung
  606.                die gleiche war, wie die erste  (nichtleere)  Zeile der
  607.                FILE_ID.DIZ Beschreibung,  so wurde diese Zeile doppelt
  608.                in die FILES.BBS eingefügt.
  609.  
  610.              - BugFix: Wenn DizMan aufgrund eines Fehlers abbrach,  so
  611.                hat  es in bestimmten  Fällen  nicht  wieder in das ur-
  612.                sprüngliche Verzeichnis zurückgewechselt.
  613.  
  614.              - BugFix: Sharing Probleme sollten behoben sein.
  615.  
  616.              - BugFix: Stand ein File schon in der FILES.BBS und  nach
  617.                der  Beschreibung folgte  eine Leerzeile so verschwandt
  618.                diese nach Einfuegen des FILE_ID.DIZ Kommentars.
  619.  
  620.              - Einige kleinere, interne Änderungen.
  621.  
  622.         1.00 - Die Baby-Version ;-)  (Turbo Pascal 6.0)
  623.  
  624. ╔═════════════════════════════════════════════════════════════════════════════╗
  625. ║                                Danke Schön...                               ║
  626. ╚═════════════════════════════════════════════════════════════════════════════╝
  627.  
  628.     Besten Dank an:
  629.  
  630.         - Johan Zwiekhorst für seine exzellente GUS Dokumentation.
  631.  
  632.         - Martin Austermeier für seine Ideen aus dem Modul DOSWIN.
  633.  
  634.         - Kim Kokkonen für seinen Artikel in Dr. Dobbs Journal 4/1988.
  635.  
  636.         - Anders Danielsson für sein Repack Programm.
  637.  
  638.         - Thomas Mainka für die ADIR Dokumentation.
  639.  
  640. ╔═════════════════════════════════════════════════════════════════════════════╗
  641. ║      Dokumentation für DizMan v1.20, geschrieben 1993 von Stefan Kuhn.      ║
  642. ╚═════════════════════════════════════════════════════════════════════════════╝
  643.